Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

First version of 18.04 upgrade documentation #60

Merged
merged 6 commits into from
Mar 8, 2019

Conversation

erelson
Copy link
Collaborator

@erelson erelson commented Feb 7, 2019

We will officially announce when the upgrade from Indigo->Melodic is
ready. This is not yet the announcement.

Feedback on this draft is welcome, however!

See also ZebraDevs/fetch_robots#27

Also closes #47

Copy link
Contributor

@moriarty moriarty left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggest backing up a few more things, but they're not required.

.. WARNING::
Read this document in full to ensure you understand the procedures. It is
not straightforward to go back to ROS Indigo/Ubuntu 14.04 after doing this.
Ensure your colleagues are on board with doing this upgrade.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I didn't check with my colleagues when I upgraded my Fetch 😆


For (2), this may include workspaces, logs, and training data.

For (3), this file may be useful::
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also if they're using any additional sensors they may have additional rules.

#. Calibration and other robot-specific files. By convention, these are
all in ``/etc/ros/[indigo|melodic]/``
#. Files relating to your research work
#. Network hardware configuration (for troubleshooting)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd suggest adding /opt/ros/indigo which in case anyone is relaying on some specific version of something they've installed they'd at least have a hope of getting something working again... It wouldn't be straightforward, and I wouldn't recommend it... but it might be useful.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll suggest grabbing a record of what's in /opt/ros/indigo. Any suggestion on how to do that or is dpkg -l | grep ros-indigo > installed_indigo_packages.txt good enough?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That, and simply tar the directory...

Because only the latest version is available from the package manager, so if they've installed their own packages in /opt/ros/* or happen to be depending on a very specific version which might not be available they'd have it... but of course it's not easy to get back to the state they were in so that's why I wouldn't recommend it.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I hadn't realized how small the contents of that directory typically are. I'll make that update.

Copy link
Contributor

@moriarty moriarty Feb 15, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeh it's basically just some binarys and header files, nothing too large.

The only thing I would hate to see is if some student who's going to be presenting a thesis soon and is off working on the writing part, then goes back to the lab after the writing is done to show it / grab a video for the defense... and the were depending on whatever version was in there.
They could flash it back to trusty/indigo and un-tar the directory, clone their workspace and no need to worry about upgrading/updating to whatever is now the latest in the indigo or melodic repos


#. **Runstop the robot**, to avoid unexpected movement of the robot.
#. Download the latest 18.04 Ubuntu installer from http://releases.ubuntu.com/18.04/
(in these instructions we use the Desktop image, version 18.04.1). Install Ubuntu
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a todo for later: make instructions for the server variant of Ubuntu.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The actual TODO is to make the installer and negate the need for these steps :) But I might take your suggestion here, and have manual steps for a server-based ubuntu setup instead of supporting an additional installer for that. (though it would potentially be super minimally different)

@erelson erelson requested a review from JeffWilson7 March 7, 2019 20:09
Copy link

@JeffWilson7 JeffWilson7 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall LGTM, just a couple minor things.

But one big question...
Are the updates for "computer.rst" in another PR? There's no documentation for using systemd instead of upstart on 18.04, and there is a step to install chrony that should probably mention it is installed by default on robots bought after whatever date.

source/indigo_to_melodic.rst Outdated Show resolved Hide resolved
source/indigo_to_melodic.rst Outdated Show resolved Hide resolved
source/indigo_to_melodic.rst Show resolved Hide resolved
@erelson
Copy link
Collaborator Author

erelson commented Mar 8, 2019

Good catches. I've updated the existing note about chrony (which is out of date by 2+ years). Doing a separate readthrough of the docs to attempt to cover both 14.04 and 18.04 would be a separate PR. (I suspect we'll wait til we're only shipping 18.04 research robots, and then revise the whole docs to talk about 18.04 only)

@JeffWilson7 JeffWilson7 self-requested a review March 8, 2019 00:29
@erelson erelson requested a review from moriarty March 8, 2019 01:38
@erelson erelson merged commit 6a416ba into fetchrobotics:master Mar 8, 2019
@erelson erelson deleted the 18.04_install branch March 8, 2019 01:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants